package com.stellar.circle.domain.sPostTag;

import com.stellar.circle.controller.admin.sPostTag.vo.*;
import com.stellar.web.core.bean.PageResult;

import java.util.List;

/**
 * 话题表领域服务接口
 *
 * @author Jqchan
 * @version 1.0
 * @date 2025-05-17 19:30:35
 */
public interface SPostTagDomainService {

    /**
     * 分页查询
     *
     * @param requestPageVO 分页查询参数
     * @return 分页结果
     */
    PageResult<SPostTagResponseVO> page(SPostTagRequestPageVO requestPageVO);

    /**
     * 更新数据
     *
     * @param requestVO 更新参数
     * @return 是否成功
     */
    Boolean update(SPostTagRequestVO requestVO);

    /**
     * 删除数据
     *
     * @param id 主键ID
     * @return 是否成功
     */
    Boolean delete(Long id);

    /**
     * 新增数据
     *
     * @param requestVO 新增参数
     * @return 是否成功
     */
    Boolean insert(SPostTagRequestVO requestVO);

    /**
     * 根据主键获取详情
     *
     * @param id 主键ID
     * @return 详情数据
     */
    SPostTagResponseVO get(Long id);

    /**
     * 获取话题列表 - MINI-APP端
     *
     * @param requestPageVO
     * @return
     */
    PageResult<SPostTagResponseVO> pageForMiniApp(SPostTagRequestPageVO requestPageVO);

    /**
     * 获取话题概览
     *
     * @return
     */
    PostTagOverviewVO getTagOverview();

    /**
     * 获取热门话题排行
     *
     * @return
     */
    List<HotTopicVO> getHotTopics();
}
